home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1998 August: Technology Seed / August 1998 ADC Seed CD.toast / Mac OS 8.5b2 / allegro-b2-pseudo-SDK / CIncludes / Icons.h < prev    next >
Encoding:
C/C++ Source or Header  |  1998-07-17  |  44.9 KB  |  1,406 lines  |  [TEXT/MPS ]
  1. /*
  2.      File:        Icons.h
  3.  
  4.      Contains:    Icon Utilities and Icon Services Interfaces.
  5.  
  6.      Version:    Technology:    Mac OS 8
  7.                  Release:    Allego Seed, Use with 3.1 Universal Interfaces
  8.  
  9.      Copyright:    © 1990-1998 by Apple Computer, Inc. All rights reserved
  10.  
  11.      Bugs?:        Please include the the file and version information (from above) with
  12.                  the problem description.  Developers belonging to one of the Apple
  13.                  developer programs can submit bug reports to:
  14.  
  15.                      devsupport@apple.com
  16.  
  17. */
  18. #ifndef __ICONS__
  19. #define __ICONS__
  20.  
  21. #ifndef __MACTYPES__
  22. #include <MacTypes.h>
  23. #endif
  24. #ifndef __QUICKDRAW__
  25. #include <Quickdraw.h>
  26. #endif
  27. #ifndef __FILES__
  28. #include <Files.h>
  29. #endif
  30. #ifndef __CODEFRAGMENTS__
  31. #include <CodeFragments.h>
  32. #endif
  33.  
  34.  
  35.  
  36. #if PRAGMA_ONCE
  37. #pragma once
  38. #endif
  39.  
  40. #ifdef __cplusplus
  41. extern "C" {
  42. #endif
  43.  
  44. #if PRAGMA_IMPORT
  45. #pragma import on
  46. #endif
  47.  
  48. #if PRAGMA_STRUCT_ALIGN
  49.     #pragma options align=mac68k
  50. #elif PRAGMA_STRUCT_PACKPUSH
  51.     #pragma pack(push, 2)
  52. #elif PRAGMA_STRUCT_PACK
  53.     #pragma pack(2)
  54. #endif
  55.  
  56. /* The following are icons for which there are both icon suites and SICNs. */
  57. /* Avoid using icon resources if possible. Use IconServices instead. */
  58.  
  59. enum {
  60.     kGenericDocumentIconResource = -4000,
  61.     kGenericStationeryIconResource = -3985,
  62.     kGenericEditionFileIconResource = -3989,
  63.     kGenericApplicationIconResource = -3996,
  64.     kGenericDeskAccessoryIconResource = -3991,
  65.     kGenericFolderIconResource    = -3999,
  66.     kPrivateFolderIconResource    = -3994,
  67.     kFloppyIconResource            = -3998,
  68.     kTrashIconResource            = -3993,
  69.     kGenericRAMDiskIconResource    = -3988,
  70.     kGenericCDROMIconResource    = -3987
  71. };
  72.  
  73. /* The following are icons for which there are SICNs only. */
  74. /* Avoid using icon resources if possible. Use IconServices instead. */
  75.  
  76. enum {
  77.     kDesktopIconResource        = -3992,
  78.     kOpenFolderIconResource        = -3997,
  79.     kGenericHardDiskIconResource = -3995,
  80.     kGenericFileServerIconResource = -3972,
  81.     kGenericSuitcaseIconResource = -3970,
  82.     kGenericMoverObjectIconResource = -3969
  83. };
  84.  
  85. /* The following are icons for which there are icon suites only. */
  86. /* Avoid using icon resources if possible. Use IconServices instead. */
  87.  
  88. enum {
  89.     kGenericPreferencesIconResource = -3971,
  90.     kGenericQueryDocumentIconResource = -16506,
  91.     kGenericExtensionIconResource = -16415,
  92.     kSystemFolderIconResource    = -3983,
  93.     kHelpIconResource            = -20271,
  94.     kAppleMenuFolderIconResource = -3982
  95. };
  96.  
  97. /* Obsolete. Use named constants defined above. */
  98.  
  99. enum {
  100.     genericDocumentIconResource    = kGenericDocumentIconResource,
  101.     genericStationeryIconResource = kGenericStationeryIconResource,
  102.     genericEditionFileIconResource = kGenericEditionFileIconResource,
  103.     genericApplicationIconResource = kGenericApplicationIconResource,
  104.     genericDeskAccessoryIconResource = kGenericDeskAccessoryIconResource,
  105.     genericFolderIconResource    = kGenericFolderIconResource,
  106.     privateFolderIconResource    = kPrivateFolderIconResource,
  107.     floppyIconResource            = kFloppyIconResource,
  108.     trashIconResource            = kTrashIconResource,
  109.     genericRAMDiskIconResource    = kGenericRAMDiskIconResource,
  110.     genericCDROMIconResource    = kGenericCDROMIconResource,
  111.     desktopIconResource            = kDesktopIconResource,
  112.     openFolderIconResource        = kOpenFolderIconResource,
  113.     genericHardDiskIconResource    = kGenericHardDiskIconResource,
  114.     genericFileServerIconResource = kGenericFileServerIconResource,
  115.     genericSuitcaseIconResource    = kGenericSuitcaseIconResource,
  116.     genericMoverObjectIconResource = kGenericMoverObjectIconResource,
  117.     genericPreferencesIconResource = kGenericPreferencesIconResource,
  118.     genericQueryDocumentIconResource = kGenericQueryDocumentIconResource,
  119.     genericExtensionIconResource = kGenericExtensionIconResource,
  120.     systemFolderIconResource    = kSystemFolderIconResource,
  121.     appleMenuFolderIconResource    = kAppleMenuFolderIconResource
  122. };
  123.  
  124. /* Avoid using icon resources if possible. Use IconServices instead. */
  125.  
  126. enum {
  127.     kStartupFolderIconResource    = -3981,
  128.     kOwnedFolderIconResource    = -3980,
  129.     kDropFolderIconResource        = -3979,
  130.     kSharedFolderIconResource    = -3978,
  131.     kMountedFolderIconResource    = -3977,
  132.     kControlPanelFolderIconResource = -3976,
  133.     kPrintMonitorFolderIconResource = -3975,
  134.     kPreferencesFolderIconResource = -3974,
  135.     kExtensionsFolderIconResource = -3973,
  136.     kFontsFolderIconResource    = -3968,
  137.     kFullTrashIconResource        = -3984
  138. };
  139.  
  140. /* Obsolete. Use named constants defined above. */
  141.  
  142. enum {
  143.     startupFolderIconResource    = kStartupFolderIconResource,
  144.     ownedFolderIconResource        = kOwnedFolderIconResource,
  145.     dropFolderIconResource        = kDropFolderIconResource,
  146.     sharedFolderIconResource    = kSharedFolderIconResource,
  147.     mountedFolderIconResource    = kMountedFolderIconResource,
  148.     controlPanelFolderIconResource = kControlPanelFolderIconResource,
  149.     printMonitorFolderIconResource = kPrintMonitorFolderIconResource,
  150.     preferencesFolderIconResource = kPreferencesFolderIconResource,
  151.     extensionsFolderIconResource = kExtensionsFolderIconResource,
  152.     fontsFolderIconResource        = kFontsFolderIconResource,
  153.     fullTrashIconResource        = kFullTrashIconResource
  154. };
  155.  
  156.  
  157. enum {
  158.     kHuge1BitMask                = FOUR_CHAR_CODE('ich#'),
  159.     kHuge4BitData                = FOUR_CHAR_CODE('ich4'),
  160.     kHuge8BitData                = FOUR_CHAR_CODE('ich8'),
  161.     kHuge32BitData                = FOUR_CHAR_CODE('ih32'),
  162.     kHuge8BitMask                = FOUR_CHAR_CODE('h8mk'),
  163.     kLarge1BitMask                = FOUR_CHAR_CODE('ICN#'),
  164.     kLarge4BitData                = FOUR_CHAR_CODE('icl4'),
  165.     kLarge8BitData                = FOUR_CHAR_CODE('icl8'),
  166.     kLarge32BitData                = FOUR_CHAR_CODE('il32'),
  167.     kLarge8BitMask                = FOUR_CHAR_CODE('l8mk'),
  168.     kSmall1BitMask                = FOUR_CHAR_CODE('ics#'),
  169.     kSmall4BitData                = FOUR_CHAR_CODE('ics4'),
  170.     kSmall8BitData                = FOUR_CHAR_CODE('ics8'),
  171.     kSmall32BitData                = FOUR_CHAR_CODE('is32'),
  172.     kSmall8BitMask                = FOUR_CHAR_CODE('s8mk'),
  173.     kMini1BitMask                = FOUR_CHAR_CODE('icm#'),
  174.     kMini4BitData                = FOUR_CHAR_CODE('icm4'),
  175.     kMini8BitData                = FOUR_CHAR_CODE('icm8')
  176. };
  177.  
  178. /* Obsolete. Use names defined above. */
  179.  
  180. enum {
  181.     large1BitMask                = kLarge1BitMask,
  182.     large4BitData                = kLarge4BitData,
  183.     large8BitData                = kLarge8BitData,
  184.     small1BitMask                = kSmall1BitMask,
  185.     small4BitData                = kSmall4BitData,
  186.     small8BitData                = kSmall8BitData,
  187.     mini1BitMask                = kMini1BitMask,
  188.     mini4BitData                = kMini4BitData,
  189.     mini8BitData                = kMini8BitData
  190. };
  191.  
  192. /* Alignment type values. */
  193.  
  194. enum {
  195.     kAlignNone                    = 0x00,
  196.     kAlignVerticalCenter        = 0x01,
  197.     kAlignTop                    = 0x02,
  198.     kAlignBottom                = 0x03,
  199.     kAlignHorizontalCenter        = 0x04,
  200.     kAlignAbsoluteCenter        = kAlignVerticalCenter | kAlignHorizontalCenter,
  201.     kAlignCenterTop                = kAlignTop | kAlignHorizontalCenter,
  202.     kAlignCenterBottom            = kAlignBottom | kAlignHorizontalCenter,
  203.     kAlignLeft                    = 0x08,
  204.     kAlignCenterLeft            = kAlignVerticalCenter | kAlignLeft,
  205.     kAlignTopLeft                = kAlignTop | kAlignLeft,
  206.     kAlignBottomLeft            = kAlignBottom | kAlignLeft,
  207.     kAlignRight                    = 0x0C,
  208.     kAlignCenterRight            = kAlignVerticalCenter | kAlignRight,
  209.     kAlignTopRight                = kAlignTop | kAlignRight,
  210.     kAlignBottomRight            = kAlignBottom | kAlignRight
  211. };
  212.  
  213. /* Obsolete. Use names defined above. */
  214.  
  215. enum {
  216.     atNone                        = kAlignNone,
  217.     atVerticalCenter            = kAlignVerticalCenter,
  218.     atTop                        = kAlignTop,
  219.     atBottom                    = kAlignBottom,
  220.     atHorizontalCenter            = kAlignHorizontalCenter,
  221.     atAbsoluteCenter            = kAlignAbsoluteCenter,
  222.     atCenterTop                    = kAlignCenterTop,
  223.     atCenterBottom                = kAlignCenterBottom,
  224.     atLeft                        = kAlignLeft,
  225.     atCenterLeft                = kAlignCenterLeft,
  226.     atTopLeft                    = kAlignTopLeft,
  227.     atBottomLeft                = kAlignBottomLeft,
  228.     atRight                        = kAlignRight,
  229.     atCenterRight                = kAlignCenterRight,
  230.     atTopRight                    = kAlignTopRight,
  231.     atBottomRight                = kAlignBottomRight
  232. };
  233.  
  234. typedef SInt16                             IconAlignmentType;
  235. /* Transform type values. */
  236.  
  237. enum {
  238.     kTransformNone                = 0x00,
  239.     kTransformDisabled            = 0x01,
  240.     kTransformOffline            = 0x02,
  241.     kTransformOpen                = 0x03,
  242.     kTransformLabel1            = 0x0100,
  243.     kTransformLabel2            = 0x0200,
  244.     kTransformLabel3            = 0x0300,
  245.     kTransformLabel4            = 0x0400,
  246.     kTransformLabel5            = 0x0500,
  247.     kTransformLabel6            = 0x0600,
  248.     kTransformLabel7            = 0x0700,
  249.     kTransformSelected            = 0x4000,
  250.     kTransformSelectedDisabled    = kTransformSelected | kTransformDisabled,
  251.     kTransformSelectedOffline    = kTransformSelected | kTransformOffline,
  252.     kTransformSelectedOpen        = kTransformSelected | kTransformOpen
  253. };
  254.  
  255. /* Obsolete. Use names defined above. */
  256.  
  257. enum {
  258.     ttNone                        = kTransformNone,
  259.     ttDisabled                    = kTransformDisabled,
  260.     ttOffline                    = kTransformOffline,
  261.     ttOpen                        = kTransformOpen,
  262.     ttLabel1                    = kTransformLabel1,
  263.     ttLabel2                    = kTransformLabel2,
  264.     ttLabel3                    = kTransformLabel3,
  265.     ttLabel4                    = kTransformLabel4,
  266.     ttLabel5                    = kTransformLabel5,
  267.     ttLabel6                    = kTransformLabel6,
  268.     ttLabel7                    = kTransformLabel7,
  269.     ttSelected                    = kTransformSelected,
  270.     ttSelectedDisabled            = kTransformSelectedDisabled,
  271.     ttSelectedOffline            = kTransformSelectedOffline,
  272.     ttSelectedOpen                = kTransformSelectedOpen
  273. };
  274.  
  275. typedef SInt16                             IconTransformType;
  276. /* Selector mask values. */
  277.  
  278. enum {
  279.     kSelectorLarge1Bit            = 0x00000001,
  280.     kSelectorLarge4Bit            = 0x00000002,
  281.     kSelectorLarge8Bit            = 0x00000004,
  282.     kSelectorLarge32Bit            = 0x00000008,
  283.     kSelectorLarge8BitMask        = 0x00000010,
  284.     kSelectorSmall1Bit            = 0x00000100,
  285.     kSelectorSmall4Bit            = 0x00000200,
  286.     kSelectorSmall8Bit            = 0x00000400,
  287.     kSelectorSmall32Bit            = 0x00000800,
  288.     kSelectorSmall8BitMask        = 0x00001000,
  289.     kSelectorMini1Bit            = 0x00010000,
  290.     kSelectorMini4Bit            = 0x00020000,
  291.     kSelectorMini8Bit            = 0x00040000,
  292.     kSelectorHuge1Bit            = 0x01000000,
  293.     kSelectorHuge4Bit            = 0x02000000,
  294.     kSelectorHuge8Bit            = 0x04000000,
  295.     kSelectorHuge32Bit            = 0x08000000,
  296.     kSelectorHuge8BitMask        = 0x10000000,
  297.     kSelectorAllLargeData        = 0x000000FF,
  298.     kSelectorAllSmallData        = 0x0000FF00,
  299.     kSelectorAllMiniData        = 0x00FF0000,
  300.     kSelectorAllHugeData        = (long)0xFF000000,
  301.     kSelectorAll1BitData        = kSelectorLarge1Bit | kSelectorSmall1Bit | kSelectorMini1Bit | kSelectorHuge1Bit,
  302.     kSelectorAll4BitData        = kSelectorLarge4Bit | kSelectorSmall4Bit | kSelectorMini4Bit | kSelectorHuge4Bit,
  303.     kSelectorAll8BitData        = kSelectorLarge8Bit | kSelectorSmall8Bit | kSelectorMini8Bit | kSelectorHuge8Bit,
  304.     kSelectorAll32BitData        = kSelectorLarge32Bit | kSelectorSmall32Bit | kSelectorHuge32Bit,
  305.     kSelectorAllAvailableData    = (long)0xFFFFFFFF
  306. };
  307.  
  308.  
  309. /* Obsolete. Use names defined above. */
  310.  
  311. enum {
  312.     svLarge1Bit                    = kSelectorLarge1Bit,
  313.     svLarge4Bit                    = kSelectorLarge4Bit,
  314.     svLarge8Bit                    = kSelectorLarge8Bit,
  315.     svSmall1Bit                    = kSelectorSmall1Bit,
  316.     svSmall4Bit                    = kSelectorSmall4Bit,
  317.     svSmall8Bit                    = kSelectorSmall8Bit,
  318.     svMini1Bit                    = kSelectorMini1Bit,
  319.     svMini4Bit                    = kSelectorMini4Bit,
  320.     svMini8Bit                    = kSelectorMini8Bit,
  321.     svAllLargeData                = kSelectorAllLargeData,
  322.     svAllSmallData                = kSelectorAllSmallData,
  323.     svAllMiniData                = kSelectorAllMiniData,
  324.     svAll1BitData                = kSelectorAll1BitData,
  325.     svAll4BitData                = kSelectorAll4BitData,
  326.     svAll8BitData                = kSelectorAll8BitData,
  327.     svAllAvailableData            = kSelectorAllAvailableData
  328. };
  329.  
  330. typedef UInt32                             IconSelectorValue;
  331. typedef CALLBACK_API( OSErr , IconActionProcPtr )(ResType theType, Handle *theIcon, void *yourDataPtr);
  332. typedef STACK_UPP_TYPE(IconActionProcPtr)                         IconActionUPP;
  333. enum { uppIconActionProcInfo = 0x00000FE0 };                     /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes) */
  334. #define NewIconActionProc(userRoutine)                             (IconActionUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppIconActionProcInfo, GetCurrentArchitecture())
  335. #define CallIconActionProc(userRoutine, theType, theIcon, yourDataPtr)  CALL_THREE_PARAMETER_UPP((userRoutine), uppIconActionProcInfo, (theType), (theIcon), (yourDataPtr))
  336. typedef IconActionProcPtr                 IconAction;
  337. typedef CALLBACK_API( Handle , IconGetterProcPtr )(ResType theType, void *yourDataPtr);
  338. typedef STACK_UPP_TYPE(IconGetterProcPtr)                         IconGetterUPP;
  339. enum { uppIconGetterProcInfo = 0x000003F0 };                     /* pascal 4_bytes Func(4_bytes, 4_bytes) */
  340. #define NewIconGetterProc(userRoutine)                             (IconGetterUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppIconGetterProcInfo, GetCurrentArchitecture())
  341. #define CallIconGetterProc(userRoutine, theType, yourDataPtr)     CALL_TWO_PARAMETER_UPP((userRoutine), uppIconGetterProcInfo, (theType), (yourDataPtr))
  342. typedef IconGetterProcPtr                 IconGetter;
  343. #if !OLDROUTINELOCATIONS
  344.  
  345. struct CIcon {
  346.     PixMap                             iconPMap;                    /*the icon's pixMap*/
  347.     BitMap                             iconMask;                    /*the icon's mask*/
  348.     BitMap                             iconBMap;                    /*the icon's bitMap*/
  349.     Handle                             iconData;                    /*the icon's data*/
  350.     SInt16                             iconMaskData[1];            /*icon's mask and BitMap data*/
  351. };
  352. typedef struct CIcon                    CIcon;
  353. typedef CIcon *                            CIconPtr;
  354. typedef CIconPtr *                        CIconHandle;
  355. EXTERN_API( CIconHandle )
  356. GetCIcon                        (SInt16                 iconID)                                ONEWORDINLINE(0xAA1E);
  357.  
  358. EXTERN_API( void )
  359. PlotCIcon                        (const Rect *            theRect,
  360.                                  CIconHandle             theIcon)                            ONEWORDINLINE(0xAA1F);
  361.  
  362. EXTERN_API( void )
  363. DisposeCIcon                    (CIconHandle             theIcon)                            ONEWORDINLINE(0xAA25);
  364.  
  365. #endif  /* !OLDROUTINELOCATIONS */
  366.  
  367. EXTERN_API( Handle )
  368. GetIcon                            (SInt16                 iconID)                                ONEWORDINLINE(0xA9BB);
  369.  
  370. EXTERN_API( void )
  371. PlotIcon                        (const Rect *            theRect,
  372.                                  Handle                 theIcon)                            ONEWORDINLINE(0xA94B);
  373.  
  374.  
  375.  
  376. /*
  377.     Note:    IconSuiteRef and IconCacheRef should be an abstract types, 
  378.             but too much source code already relies on them being of type Handle.
  379. */
  380.  
  381. typedef Handle                             IconSuiteRef;
  382. typedef Handle                             IconCacheRef;
  383. /* IconRefs are 32-bit values identifying cached icon data. IconRef 0 is invalid.*/
  384. typedef struct OpaqueIconRef*             IconRef;
  385. EXTERN_API( OSErr )
  386. PlotIconID                        (const Rect *            theRect,
  387.                                  IconAlignmentType         align,
  388.                                  IconTransformType         transform,
  389.                                  SInt16                 theResID)                            THREEWORDINLINE(0x303C, 0x0500, 0xABC9);
  390.  
  391. EXTERN_API( OSErr )
  392. NewIconSuite                    (IconSuiteRef *            theIconSuite)                        THREEWORDINLINE(0x303C, 0x0207, 0xABC9);
  393.  
  394. EXTERN_API( OSErr )
  395. AddIconToSuite                    (Handle                 theIconData,
  396.                                  IconSuiteRef             theSuite,
  397.                                  ResType                 theType)                            THREEWORDINLINE(0x303C, 0x0608, 0xABC9);
  398.  
  399. EXTERN_API( OSErr )
  400. GetIconFromSuite                (Handle *                theIconData,
  401.                                  IconSuiteRef             theSuite,
  402.                                  ResType                 theType)                            THREEWORDINLINE(0x303C, 0x0609, 0xABC9);
  403.  
  404. EXTERN_API( OSErr )
  405. ForEachIconDo                    (IconSuiteRef             theSuite,
  406.                                  IconSelectorValue         selector,
  407.                                  IconActionUPP             action,
  408.                                  void *                    yourDataPtr)                        THREEWORDINLINE(0x303C, 0x080A, 0xABC9);
  409.  
  410. EXTERN_API( OSErr )
  411. GetIconSuite                    (IconSuiteRef *            theIconSuite,
  412.                                  SInt16                 theResID,
  413.                                  IconSelectorValue         selector)                            THREEWORDINLINE(0x303C, 0x0501, 0xABC9);
  414.  
  415. EXTERN_API( OSErr )
  416. DisposeIconSuite                (IconSuiteRef             theIconSuite,
  417.                                  Boolean                 disposeData)                        THREEWORDINLINE(0x303C, 0x0302, 0xABC9);
  418.  
  419. EXTERN_API( OSErr )
  420. PlotIconSuite                    (const Rect *            theRect,
  421.                                  IconAlignmentType         align,
  422.                                  IconTransformType         transform,
  423.                                  IconSuiteRef             theIconSuite)                        THREEWORDINLINE(0x303C, 0x0603, 0xABC9);
  424.  
  425. EXTERN_API( OSErr )
  426. MakeIconCache                    (IconCacheRef *            theCache,
  427.                                  IconGetterUPP             makeIcon,
  428.                                  void *                    yourDataPtr)                        THREEWORDINLINE(0x303C, 0x0604, 0xABC9);
  429.  
  430. EXTERN_API( OSErr )
  431. LoadIconCache                    (const Rect *            theRect,
  432.                                  IconAlignmentType         align,
  433.                                  IconTransformType         transform,
  434.                                  IconCacheRef             theIconCache)                        THREEWORDINLINE(0x303C, 0x0606, 0xABC9);
  435.  
  436. EXTERN_API( OSErr )
  437. PlotIconMethod                    (const Rect *            theRect,
  438.                                  IconAlignmentType         align,
  439.                                  IconTransformType         transform,
  440.                                  IconGetterUPP             theMethod,
  441.                                  void *                    yourDataPtr)                        THREEWORDINLINE(0x303C, 0x0805, 0xABC9);
  442.  
  443. EXTERN_API( OSErr )
  444. GetLabel                        (SInt16                 labelNumber,
  445.                                  RGBColor *                labelColor,
  446.                                  Str255                 labelString)                        THREEWORDINLINE(0x303C, 0x050B, 0xABC9);
  447.  
  448. EXTERN_API( Boolean )
  449. PtInIconID                        (Point                     testPt,
  450.                                  const Rect *            iconRect,
  451.                                  IconAlignmentType         align,
  452.                                  SInt16                 iconID)                                THREEWORDINLINE(0x303C, 0x060D, 0xABC9);
  453.  
  454. EXTERN_API( Boolean )
  455. PtInIconSuite                    (Point                     testPt,
  456.                                  const Rect *            iconRect,
  457.                                  IconAlignmentType         align,
  458.                                  IconSuiteRef             theIconSuite)                        THREEWORDINLINE(0x303C, 0x070E, 0xABC9);
  459.  
  460. EXTERN_API( Boolean )
  461. PtInIconMethod                    (Point                     testPt,
  462.                                  const Rect *            iconRect,
  463.                                  IconAlignmentType         align,
  464.                                  IconGetterUPP             theMethod,
  465.                                  void *                    yourDataPtr)                        THREEWORDINLINE(0x303C, 0x090F, 0xABC9);
  466.  
  467. EXTERN_API( Boolean )
  468. RectInIconID                    (const Rect *            testRect,
  469.                                  const Rect *            iconRect,
  470.                                  IconAlignmentType         align,
  471.                                  SInt16                 iconID)                                THREEWORDINLINE(0x303C, 0x0610, 0xABC9);
  472.  
  473. EXTERN_API( Boolean )
  474. RectInIconSuite                    (const Rect *            testRect,
  475.                                  const Rect *            iconRect,
  476.                                  IconAlignmentType         align,
  477.                                  IconSuiteRef             theIconSuite)                        THREEWORDINLINE(0x303C, 0x0711, 0xABC9);
  478.  
  479. EXTERN_API( Boolean )
  480. RectInIconMethod                (const Rect *            testRect,
  481.                                  const Rect *            iconRect,
  482.                                  IconAlignmentType         align,
  483.                                  IconGetterUPP             theMethod,
  484.                                  void *                    yourDataPtr)                        THREEWORDINLINE(0x303C, 0x0912, 0xABC9);
  485.  
  486. EXTERN_API( OSErr )
  487. IconIDToRgn                        (RgnHandle                 theRgn,
  488.                                  const Rect *            iconRect,
  489.                                  IconAlignmentType         align,
  490.                                  SInt16                 iconID)                                THREEWORDINLINE(0x303C, 0x0613, 0xABC9);
  491.  
  492. EXTERN_API( OSErr )
  493. IconSuiteToRgn                    (RgnHandle                 theRgn,
  494.                                  const Rect *            iconRect,
  495.                                  IconAlignmentType         align,
  496.                                  IconSuiteRef             theIconSuite)                        THREEWORDINLINE(0x303C, 0x0714, 0xABC9);
  497.  
  498. EXTERN_API( OSErr )
  499. IconMethodToRgn                    (RgnHandle                 theRgn,
  500.                                  const Rect *            iconRect,
  501.                                  IconAlignmentType         align,
  502.                                  IconGetterUPP             theMethod,
  503.                                  void *                    yourDataPtr)                        THREEWORDINLINE(0x303C, 0x0915, 0xABC9);
  504.  
  505. EXTERN_API( OSErr )
  506. SetSuiteLabel                    (IconSuiteRef             theSuite,
  507.                                  SInt16                 theLabel)                            THREEWORDINLINE(0x303C, 0x0316, 0xABC9);
  508.  
  509. EXTERN_API( SInt16 )
  510. GetSuiteLabel                    (IconSuiteRef             theSuite)                            THREEWORDINLINE(0x303C, 0x0217, 0xABC9);
  511.  
  512. EXTERN_API( OSErr )
  513. GetIconCacheData                (IconCacheRef             theCache,
  514.                                  void **                theData)                            THREEWORDINLINE(0x303C, 0x0419, 0xABC9);
  515.  
  516. EXTERN_API( OSErr )
  517. SetIconCacheData                (IconCacheRef             theCache,
  518.                                  void *                    theData)                            THREEWORDINLINE(0x303C, 0x041A, 0xABC9);
  519.  
  520. EXTERN_API( OSErr )
  521. GetIconCacheProc                (IconCacheRef             theCache,
  522.                                  IconGetterUPP *        theProc)                            THREEWORDINLINE(0x303C, 0x041B, 0xABC9);
  523.  
  524. EXTERN_API( OSErr )
  525. SetIconCacheProc                (IconCacheRef             theCache,
  526.                                  IconGetterUPP             theProc)                            THREEWORDINLINE(0x303C, 0x041C, 0xABC9);
  527.  
  528. EXTERN_API( OSErr )
  529. PlotIconHandle                    (const Rect *            theRect,
  530.                                  IconAlignmentType         align,
  531.                                  IconTransformType         transform,
  532.                                  Handle                 theIcon)                            THREEWORDINLINE(0x303C, 0x061D, 0xABC9);
  533.  
  534. EXTERN_API( OSErr )
  535. PlotSICNHandle                    (const Rect *            theRect,
  536.                                  IconAlignmentType         align,
  537.                                  IconTransformType         transform,
  538.                                  Handle                 theSICN)                            THREEWORDINLINE(0x303C, 0x061E, 0xABC9);
  539.  
  540. EXTERN_API( OSErr )
  541. PlotCIconHandle                    (const Rect *            theRect,
  542.                                  IconAlignmentType         align,
  543.                                  IconTransformType         transform,
  544.                                  CIconHandle             theCIcon)                            THREEWORDINLINE(0x303C, 0x061F, 0xABC9);
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556. /*
  557.    IconServices is an efficient mechanism to share icon data amongst multiple 
  558.    clients. It avoids duplication of data; it provides efficient caching, 
  559.    releasing memory when the icon data is no longer needed; it can provide
  560.    the appropriate icon for any filesystem object; it can provide commonly 
  561.    used icons (caution, note, help...); it is Appearance-savvy: the icons
  562.    are switched when appropriate.
  563.    To refer to a cached icon data, IconServices uses IconRef, a 32-bit
  564.    opaque value. IconRefs are reference counted. When there are no more clients 
  565.    for an IconRef, the bitmap memory associated with it is marked as disposeable. 
  566.    Two files of same type and creator with no custom icon will have the same IconRef.
  567.    Files with custom icons will have their own IconRef.
  568. */
  569.  
  570. /*
  571.    Use the special creator kSystemIconsCreator to get "standard" icons 
  572.    that are not associated with a file, such as the help icon.
  573. */
  574.  
  575. enum {
  576.     kSystemIconsCreator            = FOUR_CHAR_CODE('macs')
  577. };
  578.  
  579.  
  580. /*
  581.    Type of the predefined/generic icons. For example, the call:
  582.    GetIconRef(kOnSystemDisk, kSystemIconsCreator, kHelpIcon, &iconRef);
  583.    will retun in iconRef the IconRef for the standard help icon.
  584. */
  585.  
  586. /* Generic Finder icons */
  587.  
  588. enum {
  589.     kClipboardIcon                = FOUR_CHAR_CODE('CLIP'),
  590.     kClippingUnknownTypeIcon    = FOUR_CHAR_CODE('clpu'),
  591.     kClippingPictureTypeIcon    = FOUR_CHAR_CODE('clpp'),
  592.     kClippingTextTypeIcon        = FOUR_CHAR_CODE('clpt'),
  593.     kClippingSoundTypeIcon        = FOUR_CHAR_CODE('clps'),
  594.     kDesktopIcon                = FOUR_CHAR_CODE('desk'),
  595.     kFinderIcon                    = FOUR_CHAR_CODE('FNDR'),
  596.     kFontSuitcaseIcon            = FOUR_CHAR_CODE('FFIL'),
  597.     kFullTrashIcon                = FOUR_CHAR_CODE('ftrh'),
  598.     kGenericApplicationIcon        = FOUR_CHAR_CODE('APPL'),
  599.     kGenericCDROMIcon            = FOUR_CHAR_CODE('cddr'),
  600.     kGenericControlPanelIcon    = FOUR_CHAR_CODE('APPC'),
  601.     kGenericControlStripModuleIcon = FOUR_CHAR_CODE('sdev'),
  602.     kGenericComponentIcon        = FOUR_CHAR_CODE('thng'),
  603.     kGenericDeskAccessoryIcon    = FOUR_CHAR_CODE('APPD'),
  604.     kGenericDocumentIcon        = FOUR_CHAR_CODE('docu'),
  605.     kGenericEditionFileIcon        = FOUR_CHAR_CODE('edtf'),
  606.     kGenericExtensionIcon        = FOUR_CHAR_CODE('INIT'),
  607.     kGenericFileServerIcon        = FOUR_CHAR_CODE('srvr'),
  608.     kGenericFontIcon            = FOUR_CHAR_CODE('ffil'),
  609.     kGenericFontScalerIcon        = FOUR_CHAR_CODE('sclr'),
  610.     kGenericFloppyIcon            = FOUR_CHAR_CODE('flpy'),
  611.     kGenericHardDiskIcon        = FOUR_CHAR_CODE('hdsk'),
  612.     kGenericRemovableMediaIcon    = FOUR_CHAR_CODE('rmov'),
  613.     kGenericMoverObjectIcon        = FOUR_CHAR_CODE('movr'),
  614.     kGenericPCCardIcon            = FOUR_CHAR_CODE('pcmc'),
  615.     kGenericPreferencesIcon        = FOUR_CHAR_CODE('pref'),
  616.     kGenericQueryDocumentIcon    = FOUR_CHAR_CODE('qery'),
  617.     kGenericRAMDiskIcon            = FOUR_CHAR_CODE('ramd'),
  618.     kGenericSharedLibaryIcon    = FOUR_CHAR_CODE('shlb'),
  619.     kGenericStationeryIcon        = FOUR_CHAR_CODE('sdoc'),
  620.     kGenericSuitcaseIcon        = FOUR_CHAR_CODE('suit'),
  621.     kGenericWORMIcon            = FOUR_CHAR_CODE('worm'),
  622.     kInternationResourcesIcon    = FOUR_CHAR_CODE('ifil'),
  623.     kKeyboardLayoutIcon            = FOUR_CHAR_CODE('kfil'),
  624.     kSoundFileIcon                = FOUR_CHAR_CODE('sfil'),
  625.     kSystemSuitcaseIcon            = FOUR_CHAR_CODE('zsys'),
  626.     kTrashIcon                    = FOUR_CHAR_CODE('trsh'),
  627.     kTrueTypeFontIcon            = FOUR_CHAR_CODE('tfil'),
  628.     kTrueTypeFlatFontIcon        = FOUR_CHAR_CODE('sfnt'),
  629.     kTrueTypeMultiFlatFontIcon    = FOUR_CHAR_CODE('ttcf')
  630. };
  631.  
  632. /* Internet locations */
  633.  
  634. enum {
  635.     kInternetLocationHTTPIcon    = FOUR_CHAR_CODE('ilht'),
  636.     kInternetLocationFTPIcon    = FOUR_CHAR_CODE('ilft'),
  637.     kInternetLocationAppleShareIcon = FOUR_CHAR_CODE('ilaf'),
  638.     kInternetLocationAppleTalkZoneIcon = FOUR_CHAR_CODE('ilat'),
  639.     kInternetLocationFileIcon    = FOUR_CHAR_CODE('ilfi'),
  640.     kInternetLocationMailIcon    = FOUR_CHAR_CODE('ilma'),
  641.     kInternetLocationNewsIcon    = FOUR_CHAR_CODE('ilnw'),
  642.     kInternetLocationGenericIcon = FOUR_CHAR_CODE('ilge')
  643. };
  644.  
  645. /* Folders */
  646.  
  647. enum {
  648.     kGenericFolderIcon            = FOUR_CHAR_CODE('fldr'),
  649.     kDropFolderIcon                = FOUR_CHAR_CODE('dbox'),
  650.     kMountedFolderIcon            = FOUR_CHAR_CODE('mntd'),
  651.     kOpenFolderIcon                = FOUR_CHAR_CODE('ofld'),
  652.     kOwnedFolderIcon            = FOUR_CHAR_CODE('ownd'),
  653.     kPrivateFolderIcon            = FOUR_CHAR_CODE('prvf'),
  654.     kSharedFolderIcon            = FOUR_CHAR_CODE('shfl')
  655. };
  656.  
  657. /* Sharing Privileges icons */
  658.  
  659. enum {
  660.     kSharingPrivsNotApplicableIcon = FOUR_CHAR_CODE('shna'),
  661.     kSharingPrivsReadOnlyIcon    = FOUR_CHAR_CODE('shro'),
  662.     kSharingPrivsReadWriteIcon    = FOUR_CHAR_CODE('shrw'),
  663.     kSharingPrivsUnknownIcon    = FOUR_CHAR_CODE('shuk'),
  664.     kSharingPrivsWritableIcon    = FOUR_CHAR_CODE('writ')
  665. };
  666.  
  667.  
  668. /* Users and Groups icons */
  669.  
  670. enum {
  671.     kUserFolderIcon                = FOUR_CHAR_CODE('ufld'),
  672.     kWorkgroupFolderIcon        = FOUR_CHAR_CODE('wfld'),
  673.     kGuestUserIcon                = FOUR_CHAR_CODE('gusr'),
  674.     kUserIcon                    = FOUR_CHAR_CODE('user'),
  675.     kOwnerIcon                    = FOUR_CHAR_CODE('susr'),
  676.     kGroupIcon                    = FOUR_CHAR_CODE('grup')
  677. };
  678.  
  679. /* Special folders */
  680.  
  681. enum {
  682.     kAppleExtrasFolderIcon        = FOUR_CHAR_CODE('aexƒ'),
  683.     kAppleMenuFolderIcon        = FOUR_CHAR_CODE('amnu'),
  684.     kApplicationsFolderIcon        = FOUR_CHAR_CODE('apps'),
  685.     kApplicationSupportFolderIcon = FOUR_CHAR_CODE('asup'),
  686.     kAssistantsFolderIcon        = FOUR_CHAR_CODE('astƒ'),
  687.     kContextualMenuItemsFolderIcon = FOUR_CHAR_CODE('cmnu'),
  688.     kControlPanelDisabledFolderIcon = FOUR_CHAR_CODE('ctrD'),
  689.     kControlPanelFolderIcon        = FOUR_CHAR_CODE('ctrl'),
  690.     kControlStripModulesFolderIcon = FOUR_CHAR_CODE('sdvƒ'),
  691.     kDocumentsFolderIcon        = FOUR_CHAR_CODE('docs'),
  692.     kExtensionsDisabledFolderIcon = FOUR_CHAR_CODE('extD'),
  693.     kExtensionsFolderIcon        = FOUR_CHAR_CODE('extn'),
  694.     kFavoritesFolderIcon        = FOUR_CHAR_CODE('favs'),
  695.     kFontsFolderIcon            = FOUR_CHAR_CODE('font'),
  696.     kHelpFolderIcon                = FOUR_CHAR_CODE('ƒhlp'),
  697.     kInternetFolderIcon            = FOUR_CHAR_CODE('intƒ'),
  698.     kInternetPlugInFolderIcon    = FOUR_CHAR_CODE('ƒnet'),
  699.     kMacOSReadMeFolderIcon        = FOUR_CHAR_CODE('morƒ'),
  700.     kPreferencesFolderIcon        = FOUR_CHAR_CODE('prfƒ'),
  701.     kPrinterDescriptionFolderIcon = FOUR_CHAR_CODE('ppdf'),
  702.     kPrinterDriverFolderIcon    = FOUR_CHAR_CODE('ƒprd'),
  703.     kPrintMonitorFolderIcon        = FOUR_CHAR_CODE('prnt'),
  704.     kRecentApplicationsFolderIcon = FOUR_CHAR_CODE('rapp'),
  705.     kRecentDocumentsFolderIcon    = FOUR_CHAR_CODE('rdoc'),
  706.     kRecentServersFolderIcon    = FOUR_CHAR_CODE('rsrv'),
  707.     kScriptingAdditionsFolderIcon = FOUR_CHAR_CODE('ƒscr'),
  708.     kSharedLibrariesFolderIcon    = FOUR_CHAR_CODE('ƒlib'),
  709.     kScriptsFolderIcon            = FOUR_CHAR_CODE('scrƒ'),
  710.     kShutdownItemsDisabledFolderIcon = FOUR_CHAR_CODE('shdD'),
  711.     kShutdownItemsFolderIcon    = FOUR_CHAR_CODE('shdf'),
  712.     kSpeakableItemsFolder        = FOUR_CHAR_CODE('spki'),
  713.     kStartupItemsDisabledFolderIcon = FOUR_CHAR_CODE('strD'),
  714.     kStartupItemsFolderIcon        = FOUR_CHAR_CODE('strt'),
  715.     kSystemExtensionDisabledFolderIcon = FOUR_CHAR_CODE('macD'),
  716.     kSystemFolderIcon            = FOUR_CHAR_CODE('macs'),
  717.     kTextEncodingsFolderIcon    = FOUR_CHAR_CODE('ƒtex'),
  718.     kAppearanceFolderIcon        = FOUR_CHAR_CODE('appr'),
  719.     kUtilitiesFolderIcon        = FOUR_CHAR_CODE('utiƒ'),
  720.     kVoicesFolderIcon            = FOUR_CHAR_CODE('fvoc'),
  721.     kColorSyncFolderIcon        = FOUR_CHAR_CODE('prof'),
  722.     kInternetSearchSitesFolderIcon = FOUR_CHAR_CODE('issf')
  723. };
  724.  
  725. /* Badges */
  726.  
  727. enum {
  728.     kAppleScriptBadgeIcon        = FOUR_CHAR_CODE('scrp'),
  729.     kLockedBadgeIcon            = FOUR_CHAR_CODE('lbdg'),
  730.     kMountedBadgeIcon            = FOUR_CHAR_CODE('mbdg'),
  731.     kSharedBadgeIcon            = FOUR_CHAR_CODE('sbdg'),
  732.     kAliasBadgeIcon                = FOUR_CHAR_CODE('abdg')
  733. };
  734.  
  735. /* Alert icons */
  736.  
  737. enum {
  738.     kAlertNoteIcon                = FOUR_CHAR_CODE('note'),
  739.     kAlertCautionIcon            = FOUR_CHAR_CODE('caut'),
  740.     kAlertStopIcon                = FOUR_CHAR_CODE('stop')
  741. };
  742.  
  743. /* Networking icons */
  744.  
  745. enum {
  746.     kAppleTalkIcon                = FOUR_CHAR_CODE('atlk'),
  747.     kAppleTalkZoneIcon            = FOUR_CHAR_CODE('atzn'),
  748.     kAFPServerIcon                = FOUR_CHAR_CODE('afps'),
  749.     kFTPServerIcon                = FOUR_CHAR_CODE('ftps'),
  750.     kIPFileServerIcon            = FOUR_CHAR_CODE('isrv')
  751. };
  752.  
  753. /* Other icons */
  754.  
  755. enum {
  756.     kAppleLogoIcon                = FOUR_CHAR_CODE('capl'),
  757.     kAppleMenuIcon                = FOUR_CHAR_CODE('sapl'),
  758.     kBackwardArrowIcon            = FOUR_CHAR_CODE('baro'),
  759.     kFavoriteItemsIcon            = FOUR_CHAR_CODE('favr'),
  760.     kForwardArrowIcon            = FOUR_CHAR_CODE('faro'),
  761.     kGridIcon                    = FOUR_CHAR_CODE('grid'),
  762.     kHelpIcon                    = FOUR_CHAR_CODE('help'),
  763.     kKeepArrangedIcon            = FOUR_CHAR_CODE('arng'),
  764.     kLockedIcon                    = FOUR_CHAR_CODE('lock'),
  765.     kNoFilesIcon                = FOUR_CHAR_CODE('nfil'),
  766.     kNoFolderIcon                = FOUR_CHAR_CODE('nfld'),
  767.     kNoWriteIcon                = FOUR_CHAR_CODE('nwrt'),
  768.     kProtectedApplicationFolderIcon = FOUR_CHAR_CODE('papp'),
  769.     kProtectedSystemFolderIcon    = FOUR_CHAR_CODE('psys'),
  770.     kRecentItemsIcon            = FOUR_CHAR_CODE('rcnt'),
  771.     kShortcutIcon                = FOUR_CHAR_CODE('shrt'),
  772.     kSortAscendingIcon            = FOUR_CHAR_CODE('asnd'),
  773.     kSortDescendingIcon            = FOUR_CHAR_CODE('dsnd'),
  774.     kUnlockedIcon                = FOUR_CHAR_CODE('ulck'),
  775.     kConnectToIcon                = FOUR_CHAR_CODE('cnct')
  776. };
  777.  
  778.  
  779. /*    Error codes range from -2580 to -2599 */
  780.  
  781. enum {
  782.     invalidIconRefErr            = -2580,
  783.     noSuchIconErr                = -2581,
  784.     noIconDataAvailableErr        = -2582
  785. };
  786.  
  787.  
  788. /*    IconServicesUsageFlags */
  789. typedef UInt32                             IconServicesUsageFlags;
  790.  
  791. enum {
  792.     kIconServicesNormalUsageFlag = 0
  793. };
  794.  
  795.  
  796. /*
  797.       IconFamily 'icns' resources contain an entire IconFamily (all sizes and depths).  
  798.    For custom icons, icns IconFamily resources of the custom icon resource ID are fetched first before
  799.    the classic custom icons (individual 'ics#, ICN#, etc) are fetched.  If the fetch of the icns resource
  800.    succeeds then the icns is looked at exclusively for the icon data.
  801.    For custom icons, new icon features such as 32-bit deep icons are only fetched from the icns resource.
  802.    This is to avoid incompatibilities with cut & paste of new style icons with an older version of the
  803.    MacOS Finder.
  804.    DriverGestalt is called with code kdgMediaIconSuite by IconServices after calling FSM to determine a
  805.    driver icon for a particular device.  The result of the kdgMediaIconSuite call to DriverGestalt should
  806.    be a pointer an an IconFamily.  In this manner driver vendors can provide rich, detailed drive icons
  807.    instead of the 1-bit variety previously supported.
  808. */
  809.  
  810. enum {
  811.     kIconFamilyType                = FOUR_CHAR_CODE('icns')
  812. };
  813.  
  814.  
  815.  
  816. struct IconFamilyElement {
  817.     OSType                             elementType;                /* 'ICN#', 'icl8', etc...*/
  818.     Size                             elementSize;                /* Size of this element*/
  819.     unsigned char                     elementData[1];
  820. };
  821. typedef struct IconFamilyElement        IconFamilyElement;
  822.  
  823. struct IconFamilyResource {
  824.     OSType                             resourceType;                /* Always 'icns'*/
  825.     Size                             resourceSize;                /* Total size of this resource*/
  826.     IconFamilyElement                 elements[1];
  827.  
  828. };
  829. typedef struct IconFamilyResource        IconFamilyResource;
  830.  
  831. typedef IconFamilyResource *            IconFamilyPtr;
  832. typedef IconFamilyPtr *                    IconFamilyHandle;
  833.  
  834. /*
  835.   ==============================================================================
  836.    Initialization and Termination
  837.   ==============================================================================
  838. */
  839.  
  840.  
  841. /*
  842.    IconServicesInit
  843.    
  844.    Call this routine once per classic 68K application initialization.
  845.    This routine does not need to be called at boot time.
  846. */
  847.  
  848. EXTERN_API( OSErr )
  849. IconServicesInit                (CFragInitBlockPtr         initBlockPtr)                        TWOWORDINLINE(0x7015, 0xAA75);
  850.  
  851.  
  852. /*
  853.    IconServicesTerminate:
  854.    
  855.    Call this routine once from the termination of a classic 68K application.
  856.    This routine does not need to be called at boot time.
  857. */
  858.  
  859. EXTERN_API( void )
  860. IconServicesTerminate            (void)                                                        TWOWORDINLINE(0x7016, 0xAA75);
  861.  
  862.  
  863.  
  864. /*
  865.   ==============================================================================
  866.    Converting data structures
  867.   ==============================================================================
  868. */
  869.  
  870.  
  871. /*
  872.    IconRefToIconFamily
  873.    This routines returns a new IconFamily that contains the data corresponding
  874.    to the specified IconRef
  875. */
  876.  
  877. EXTERN_API( OSErr )
  878. IconRefToIconFamily                (IconRef                 theIconRef,
  879.                                  IconSelectorValue         whichIcons,
  880.                                  IconFamilyHandle *        iconFamily)                            TWOWORDINLINE(0x7024, 0xAA75);
  881.  
  882.  
  883. /*
  884.    IconFamilyToIconSuite
  885.    This routines transfers the data in an icon family into an icon suite.
  886. */
  887.  
  888. EXTERN_API( OSErr )
  889. IconFamilyToIconSuite            (IconFamilyHandle         iconFamily,
  890.                                  IconSelectorValue         whichIcons,
  891.                                  IconSuiteRef *            iconSuite)                            TWOWORDINLINE(0x7025, 0xAA75);
  892.  
  893.  
  894. /*
  895.    IconSuiteToIconFamily
  896.    This routines transfers the data in an icon suite into an icon family.
  897. */
  898.  
  899. EXTERN_API( OSErr )
  900. IconSuiteToIconFamily            (IconSuiteRef             iconSuite,
  901.                                  IconSelectorValue         whichIcons,
  902.                                  IconFamilyHandle *        iconFamily)                            TWOWORDINLINE(0x7026, 0xAA75);
  903.  
  904.  
  905. /*
  906.    SetIconFamilyData
  907.    Change the data of an icon family. The data is copied.
  908.    The type can be one of the icon type, or 'PICT'
  909.    The data will be compressed if needed.
  910. */
  911.  
  912. EXTERN_API( OSErr )
  913. SetIconFamilyData                (IconFamilyHandle         iconFamily,
  914.                                  OSType                 iconType,
  915.                                  Handle                 h)                                    TWOWORDINLINE(0x7030, 0xAA75);
  916.  
  917.  
  918. /*
  919.    GetIconFamilyData
  920.    Return a copy of the data in the icon family.
  921.    The type can be one of the icon type, or 'PICT'
  922.    The data will be returned uncompressed.
  923. */
  924.  
  925. EXTERN_API( OSErr )
  926. GetIconFamilyData                (IconFamilyHandle         iconFamily,
  927.                                  OSType                 iconType,
  928.                                  Handle                 h)                                    TWOWORDINLINE(0x7031, 0xAA75);
  929.  
  930.  
  931. /*
  932.   ==============================================================================
  933.    Reference counting
  934.   ==============================================================================
  935. */
  936.  
  937.  
  938. /*
  939.    GetIconRefOwners
  940.    
  941.    This routine returns the reference count for the IconRef, or number of owners.
  942.    
  943.    A valid IconRef always has at least one owner.
  944. */
  945.  
  946. EXTERN_API( OSErr )
  947. GetIconRefOwners                (IconRef                 theIconRef,
  948.                                  UInt16 *                owners)                                TWOWORDINLINE(0x700B, 0xAA75);
  949.  
  950.  
  951. /*
  952.    AcquireIconRef
  953.    This routine increments the reference count for the IconRef
  954. */
  955.  
  956. EXTERN_API( OSErr )
  957. AcquireIconRef                    (IconRef                 theIconRef)                            TWOWORDINLINE(0x7027, 0xAA75);
  958.  
  959.  
  960.  
  961. /*
  962.    ReleaseIconRef
  963.    
  964.    This routine decrements the reference count for the IconRef.
  965.    
  966.    When the reference count reaches 0, all memory allocated for the icon
  967.    is disposed. Any subsequent use of the IconRef is invalid.
  968. */
  969.  
  970. EXTERN_API( OSErr )
  971. ReleaseIconRef                    (IconRef                 theIconRef)                            TWOWORDINLINE(0x7028, 0xAA75);
  972.  
  973.  
  974.  
  975. /*
  976.   ==============================================================================
  977.    Getting an IconRef
  978.   ==============================================================================
  979. */
  980.  
  981.  
  982. /*
  983.    GetIconRefFromFile
  984.    
  985.    This routine returns an icon ref for the specified file, folder or volume.
  986.    The label information is provided separately, since two files with the same icon 
  987.    but a different label would share the same iconRef. The label can be used in 
  988.    PlotIconRef() for example.
  989.    
  990.    Use this routine if you have no information about the file system object. If 
  991.    you have already done a GetCatInfo on the file and want to save some I/O, 
  992.    call GetIconRefFromFolder() if you know it's a folder with no custom icon or 
  993.    call GetIconRef() if it's a file with no custom icon.
  994.    This routine increments the reference count of the returned IconRef. Call 
  995.    ReleaseIconRef() when you're done with it.
  996. */
  997.  
  998. EXTERN_API( OSErr )
  999. GetIconRefFromFile                (const FSSpec *            theFile,
  1000.                                  IconRef *                theIconRef,
  1001.                                  SInt16 *                theLabel)                            TWOWORDINLINE(0x7002, 0xAA75);
  1002.  
  1003.  
  1004. /*
  1005.    GetBaseIconRefFromFile
  1006.    
  1007.    This routine returns the base icon ref for a file, that is, the icon 
  1008.    without any badge applied to it. In most cases, you should call 
  1009.    GetIconRefFromFile.
  1010. */
  1011. EXTERN_API( OSErr )
  1012. GetBaseIconRefFromFile            (const FSSpec *            theFile,
  1013.                                  IconRef *                theIconRef,
  1014.                                  SInt16 *                theLabel)                            TWOWORDINLINE(0x702E, 0xAA75);
  1015.  
  1016.  
  1017. /*
  1018.    GetIconRef
  1019.    
  1020.    This routine returns an icon ref for an icon in the desktop database or
  1021.    for a registered icon.
  1022.    The system registers a set of icon such as the help icon with the creator 
  1023.    code kSystemIconCreator. See above for a list of the registered system types.
  1024.    The vRefNum is used as a hint on where to look for the icon first. Use 
  1025.    kOnSystemDisk if you don't know what to pass.
  1026.    This routine increments the reference count of the returned IconRef. Call 
  1027.    ReleaseIconRef() when you're done with it.
  1028. */
  1029.  
  1030. EXTERN_API( OSErr )
  1031. GetIconRef                        (SInt16                 vRefNum,
  1032.                                  OSType                 creator,
  1033.                                  OSType                 iconType,
  1034.                                  IconRef *                theIconRef)                            TWOWORDINLINE(0x7021, 0xAA75);
  1035.  
  1036.  
  1037.  
  1038. /*
  1039.    GetIconRefFromFolder
  1040.    
  1041.    This routine returns an icon ref for a folder with no custom icon.
  1042.    Use the more generic, but slightly slower, GetIconRefFromFile() if
  1043.    you don't already have the necessary info about the file.
  1044.    Attributes should be CInfoPBRec.dirInfo.ioFlAttrib for this folder.
  1045.    Access privileges should be CInfoPBRec.dirInfo.ioACUser for this folder.
  1046.    This routine increments the reference count of the IconRef. Call ReleaseIconRef() 
  1047.    when you're done with it.
  1048. */
  1049.  
  1050. EXTERN_API( OSErr )
  1051. GetIconRefFromFolder            (SInt16                 vRefNum,
  1052.                                  SInt32                 parentFolderID,
  1053.                                  SInt32                 folderID,
  1054.                                  SInt8                     attributes,
  1055.                                  SInt8                     accessPrivileges,
  1056.                                  IconRef *                theIconRef)                            TWOWORDINLINE(0x7022, 0xAA75);
  1057.  
  1058.  
  1059.  
  1060. /*
  1061.   ==============================================================================
  1062.    Adding and modifying IconRef
  1063.   ==============================================================================
  1064. */
  1065.  
  1066.  
  1067. /*
  1068.    RegisterIconRefFromIconFamily
  1069.    This routine adds a new entry to the IconRef registry. Other clients will be 
  1070.    able to access it using the (creator, iconType) pair specified here.
  1071.    Lower-case creators are reserved for the system.
  1072.    Consider using RegisterIconRefFromResource() if possible, since the data 
  1073.    registered using RegisterIconRefFromFamily() cannot be purged.
  1074.    The iconFamily data is copied and the caller is reponsible for disposing of it.
  1075.    This routine increments the reference count of the IconRef. Call ReleaseIconRef() 
  1076.    when you're done with it.
  1077. */
  1078.  
  1079. EXTERN_API( OSErr )
  1080. RegisterIconRefFromIconFamily    (OSType                 creator,
  1081.                                  OSType                 iconType,
  1082.                                  IconFamilyHandle         iconFamily,
  1083.                                  IconRef *                theIconRef)                            TWOWORDINLINE(0x701C, 0xAA75);
  1084.  
  1085.  
  1086. /*
  1087.    RegisterIconRefFromResource
  1088.    
  1089.    Registers an IconRef from a resouce file.  
  1090.    The icon data to be fetched is either classic icon data or an icon family.  
  1091.    The 'icns' icon family is searched for before the classic icon data.
  1092.    This routine increments the reference count of the IconRef. Call ReleaseIconRef() 
  1093.    when you're done with it.
  1094. */
  1095.  
  1096. EXTERN_API( OSErr )
  1097. RegisterIconRefFromResource        (OSType                 creator,
  1098.                                  OSType                 iconType,
  1099.                                  const FSSpec *            resourceFile,
  1100.                                  SInt16                 resourceID,
  1101.                                  IconRef *                theIconRef)                            TWOWORDINLINE(0x7023, 0xAA75);
  1102.  
  1103.  
  1104. /*
  1105.    UnregisterIconRef
  1106.    
  1107.    Removes the specified icon from the icon cache (if there are no users of it).  
  1108.    If some clients are using this iconRef, then the IconRef will be removed when the 
  1109.    last user calls ReleaseIconRef.
  1110. */
  1111.  
  1112. EXTERN_API( OSErr )
  1113. UnregisterIconRef                (OSType                 creator,
  1114.                                  OSType                 iconType)                            TWOWORDINLINE(0x7008, 0xAA75);
  1115.  
  1116.  
  1117.  
  1118. /*
  1119.    UpdateIconRef
  1120.    
  1121.    Call this routine to force an update of the data for iconRef.
  1122.    
  1123.    For example after changing an icon in the desktop database or changing the custom 
  1124.    icon of a file. Note that after _adding_ a custom icon to file or folder, you 
  1125.    need to call GetIconRefFromFile() to get a new IconRef specific to this file. 
  1126.    
  1127.    This routine does nothing if the IconRef is a registered icon.
  1128. */
  1129.  
  1130. EXTERN_API( OSErr )
  1131. UpdateIconRef                    (IconRef                 theIconRef)                            TWOWORDINLINE(0x7009, 0xAA75);
  1132.  
  1133.  
  1134.  
  1135. /*
  1136.    OverrideIconRefFromResource
  1137.    
  1138.    This routines replaces the bitmaps of the specified IconRef with the ones
  1139.    in the specified resource file.
  1140. */
  1141.  
  1142. EXTERN_API( OSErr )
  1143. OverrideIconRefFromResource        (IconRef                 theIconRef,
  1144.                                  const FSSpec *            resourceFile,
  1145.                                  SInt16                 resourceID)                            TWOWORDINLINE(0x702A, 0xAA75);
  1146.  
  1147.  
  1148.  
  1149. /*
  1150.    OverrideIconRef
  1151.    
  1152.    This routines replaces the bitmaps of the specified IconRef with the ones
  1153.    from the new IconRef.
  1154. */
  1155.  
  1156. EXTERN_API( OSErr )
  1157. OverrideIconRef                    (IconRef                 oldIconRef,
  1158.                                  IconRef                 newIconRef)                            TWOWORDINLINE(0x702B, 0xAA75);
  1159.  
  1160.  
  1161. /*
  1162.    RemoveIconRefOverride
  1163.    This routine remove an override if one was applied to the icon and 
  1164.    reverts back to the original bitmap data.
  1165. */
  1166.  
  1167. EXTERN_API( OSErr )
  1168. RemoveIconRefOverride            (IconRef                 theIconRef)                            TWOWORDINLINE(0x701E, 0xAA75);
  1169.  
  1170.  
  1171.  
  1172. /*
  1173.   ==============================================================================
  1174.    Creating composite IconRef
  1175.   ==============================================================================
  1176. */
  1177.  
  1178.  
  1179. /*
  1180.    CompositeIconRef
  1181.    
  1182.    Superimposes an IconRef on top of another one
  1183. */
  1184.  
  1185. EXTERN_API( OSErr )
  1186. CompositeIconRef                (IconRef                 backgroundIconRef,
  1187.                                  IconRef                 foregroundIconRef,
  1188.                                  IconRef *                compositeIconRef)                    TWOWORDINLINE(0x7014, 0xAA75);
  1189.  
  1190.  
  1191. /*
  1192.    IsIconRefComposite
  1193.    Indicates if a given icon ref is a composite of two other icon refs (and which ones)
  1194.    If it isn't a composite, backgroundIconRef and foreGroundIconRef will be 0.
  1195. */
  1196.  
  1197. EXTERN_API( OSErr )
  1198. IsIconRefComposite                (IconRef                 compositeIconRef,
  1199.                                  IconRef *                backgroundIconRef,
  1200.                                  IconRef *                foregroundIconRef)                    TWOWORDINLINE(0x701A, 0xAA75);
  1201.  
  1202.  
  1203.  
  1204. /*
  1205.   ==============================================================================
  1206.    Using IconRef
  1207.   ==============================================================================
  1208. */
  1209.  
  1210. /*
  1211.    IsValidIconRef
  1212.    Return true if the iconRef passed in is a valid icon ref
  1213. */
  1214.  
  1215. EXTERN_API( Boolean )
  1216. IsValidIconRef                    (IconRef                 theIconRef)                            TWOWORDINLINE(0x700E, 0xAA75);
  1217.  
  1218.  
  1219. /*
  1220.    PlotIconRef
  1221.    
  1222.    This routine plots the IconRef.  It mostly takes the same parameters as PlotIconSuite.
  1223.    Pass kIconServicesNormalUsageFlag as a default value for IconServicesUsageFlags.
  1224. */
  1225.  
  1226. EXTERN_API( OSErr )
  1227. PlotIconRef                        (const Rect *            theRect,
  1228.                                  IconAlignmentType         align,
  1229.                                  IconTransformType         transform,
  1230.                                  IconServicesUsageFlags  theIconServicesUsageFlags,
  1231.                                  IconRef                 theIconRef)                            TWOWORDINLINE(0x700E, 0xAA75);
  1232.  
  1233.  
  1234. /*
  1235.    PtInIconRef
  1236.    
  1237.    This routine indicates if testPt would hit the icon designated by iconRef.
  1238.    It mostly takes the same parameters as PtInIconSuite.
  1239.    Pass kIconServicesNormalUsageFlag as a default value for IconServicesUsageFlags.
  1240. */
  1241.  
  1242.  
  1243. EXTERN_API( Boolean )
  1244. PtInIconRef                        (const Point *            testPt,
  1245.                                  const Rect *            iconRect,
  1246.                                  IconAlignmentType         align,
  1247.                                  IconServicesUsageFlags  theIconServicesUsageFlags,
  1248.                                  IconRef                 theIconRef)                            TWOWORDINLINE(0x700F, 0xAA75);
  1249.  
  1250.  
  1251. /*
  1252.    RectInIconRef
  1253.    
  1254.    This routine indicates if testRect would intersect the icon designated by iconRef.
  1255.    It mostly takes the same parameters as RectInIconSuite.
  1256.    Pass kIconServicesNormalUsageFlag as a default value for IconServicesUsageFlags.
  1257. */
  1258.  
  1259.  
  1260. EXTERN_API( Boolean )
  1261. RectInIconRef                    (const Rect *            testRect,
  1262.                                  const Rect *            iconRect,
  1263.                                  IconAlignmentType         align,
  1264.                                  IconServicesUsageFlags  iconServicesUsageFlags,
  1265.                                  IconRef                 theIconRef)                            TWOWORDINLINE(0x7010, 0xAA75);
  1266.  
  1267.  
  1268. /*
  1269.    IconRefToRgn
  1270.    
  1271.    This routine returns a region for the icon.
  1272.    It mostly takes the same parameters as IconSuiteToRgn.
  1273.    Pass kIconServicesNormalUsageFlag as a default value for IconServicesUsageFlags.
  1274. */
  1275.  
  1276. EXTERN_API( OSErr )
  1277. IconRefToRgn                    (RgnHandle                 theRgn,
  1278.                                  const Rect *            iconRect,
  1279.                                  IconAlignmentType         align,
  1280.                                  IconServicesUsageFlags  iconServicesUsageFlags,
  1281.                                  IconRef                 theIconRef)                            TWOWORDINLINE(0x7011, 0xAA75);
  1282.  
  1283.  
  1284. /*
  1285.    GetIconSizesFromIconRef
  1286.    
  1287.    This routine returns an IconSelectorValue indicating the depths and sizes of 
  1288.    icon data which are actually available.  It takes an IconSelectorValue 
  1289.    indicating which sizes/depths the caller is interested and returns an 
  1290.    IconSelectorValue indicating which sizes/depths exist.
  1291.    
  1292.    Caution:
  1293.    
  1294.    This is potentially an extremely expensive call as IconServices may be forced 
  1295.    to attempt fetching the data for the IconRef's sizes/depths which may result 
  1296.    in hitting the local disk or even the network to obtain the data to determine 
  1297.    which sizes/depths actually exist.
  1298.    Pass kIconServicesNormalUsageFlag as a default value for IconServicesUsageFlags.
  1299. */
  1300.  
  1301. EXTERN_API( OSErr )
  1302. GetIconSizesFromIconRef            (IconSelectorValue         iconSelectorInput,
  1303.                                  IconSelectorValue *    iconSelectorOutputPtr,
  1304.                                  IconServicesUsageFlags  iconServicesUsageFlags,
  1305.                                  IconRef                 theIconRef)                            TWOWORDINLINE(0x7012, 0xAA75);
  1306.  
  1307.  
  1308.  
  1309. /*
  1310.   ==============================================================================
  1311.    Flushing IconRef data
  1312.   ==============================================================================
  1313. */
  1314.  
  1315.  
  1316. /*
  1317.    FlushIconRefs
  1318.    
  1319.    Making this call will dispose of all the data for the specified icons if 
  1320.    the data can be reacquired, for example if the data is provided from a resource.
  1321.    '****' is a wildcard for all types or all creators.
  1322. */
  1323.  
  1324. EXTERN_API( OSErr )
  1325. FlushIconRefs                    (OSType                 creator,
  1326.                                  OSType                 iconType)                            TWOWORDINLINE(0x7029, 0xAA75);
  1327.  
  1328.  
  1329. /*
  1330.    FlushIconRefsByVolume
  1331.    
  1332.    This routine disposes of the data for the icons related to the indicated volume
  1333.    if this data can be reacquired, for example if the data is provided from a 
  1334.    resource.
  1335. */
  1336.  
  1337. EXTERN_API( OSErr )
  1338. FlushIconRefsByVolume            (SInt16                 vRefNum)                            TWOWORDINLINE(0x7018, 0xAA75);
  1339.  
  1340.  
  1341.  
  1342. /*
  1343.   ==============================================================================
  1344.    Controling custom icons
  1345.   ==============================================================================
  1346. */
  1347.  
  1348.  
  1349. /*
  1350.    SetCustomIconsEnabled
  1351.    
  1352.    Enable or disable custom icons on the specified volume.
  1353. */
  1354.  
  1355. EXTERN_API( OSErr )
  1356. SetCustomIconsEnabled            (SInt16                 vRefNum,
  1357.                                  Boolean                 enableCustomIcons)                    TWOWORDINLINE(0x701F, 0xAA75);
  1358.  
  1359.  
  1360. /*
  1361.    GetCustomIconsEnabled
  1362.    
  1363.    Return true if custom icons are enabled on the specified volume, false otherwise.
  1364. */
  1365.  
  1366. EXTERN_API( OSErr )
  1367. GetCustomIconsEnabled            (SInt16                 vRefNum,
  1368.                                  Boolean *                customIconsEnabled)                    TWOWORDINLINE(0x7020, 0xAA75);
  1369.  
  1370.  
  1371. /*
  1372.    SetCustomIconFamily
  1373.    Sets the custom icon of a file or folder.
  1374.    AliasIcon should be true to indicate you want to specify the 
  1375.    appearance that the alias file should have. You can further
  1376.    override the appearance of the alias by specifying a custom 
  1377.    icon.
  1378. */
  1379. EXTERN_API( OSErr )
  1380. SetCustomIconFamily                (const FSSpec *            theFile,
  1381.                                  Boolean                 aliasIcon,
  1382.                                  IconRef                 customIcon)                            TWOWORDINLINE(0x702F, 0xAA75);
  1383.  
  1384.  
  1385.  
  1386. #if PRAGMA_STRUCT_ALIGN
  1387.     #pragma options align=reset
  1388. #elif PRAGMA_STRUCT_PACKPUSH
  1389.     #pragma pack(pop)
  1390. #elif PRAGMA_STRUCT_PACK
  1391.     #pragma pack()
  1392. #endif
  1393.  
  1394. #ifdef PRAGMA_IMPORT_OFF
  1395. #pragma import off
  1396. #elif PRAGMA_IMPORT
  1397. #pragma import reset
  1398. #endif
  1399.  
  1400. #ifdef __cplusplus
  1401. }
  1402. #endif
  1403.  
  1404. #endif /* __ICONS__ */
  1405.  
  1406.